Crate rancor

rancor

rancor provides scalable and efficient error handling without using type composition. This makes it best-suited for situations where:

• Programmatic error introspection is not useful
• Functions may error, but succeed most of the time
• Errors should provide as much useful detail as possible when emitted
• Use cases include both no_std and targets with support for std

Features

• alloc: Provides the BoxedError type. Enabled by default.

Macros

• fail
  Returns the given error from this function.

Structs

• BoxedErroralloc
  An error type that preserves all detailed error messages. It is optimized to fit in a single pointer.
• Error
  A good general-purpose error type.
• Failure
  An error type that only preserves success or failure, throwing away any more detailed error messages.
• Strategy
  Equips a type with a Fallible implementation that chooses E as its error type.

Enums

• Infallible
  A re-export of core::convert::Infallible. The error type for errors that can never happen.
• Panic
  An error type that does not occupy any space, panicking on creation instead.

Traits

• Fallible
  A type with fallible operations that return its associated error type.
• Never
  A type that can never be produced.
• OptionExt
  Helper methods for Options.
• ResultExt
  Helper methods for Results.
• Source
  An error type which can be uniformly constructed from an Error and additional trace information.
• Trace
  An error type which can add additional “trace” information to itself.

Functions

• unreachable_checked
  Consumes a Never type, returning a primitive !.